package cn.csc.module.member.service.role;

import cn.csc.framework.common.pojo.PageResult;
import cn.csc.module.member.controller.app.role.vo.AppMemberRoleCreateReqVO;
import cn.csc.module.member.controller.app.role.vo.AppMemberRoleExportReqVO;
import cn.csc.module.member.controller.app.role.vo.AppMemberRolePageReqVO;
import cn.csc.module.member.controller.app.role.vo.AppMemberRoleUpdateReqVO;
import cn.csc.module.member.dal.dataobject.role.MemberRoleDO;

import javax.validation.Valid;
import java.math.BigInteger;
import java.util.Collection;
import java.util.List;

/**
 * 会员角色 Service 接口
 *
 * @author liuchuang
 */
public interface MemberRoleService {

    /**
     * 创建会员角色
     *
     * @param createReqVO 创建信息
     * @return 编号
     */
    BigInteger createRole(@Valid AppMemberRoleCreateReqVO createReqVO);

    /**
     * 更新会员角色
     *
     * @param updateReqVO 更新信息
     */
    void updateRole(@Valid AppMemberRoleUpdateReqVO updateReqVO);

    /**
     * 删除会员角色
     *
     * @param id 编号
     */
    void deleteRole(BigInteger id);

    /**
     * 获得会员角色
     *
     * @param id 编号
     * @return 会员角色
     */
    MemberRoleDO getRole(BigInteger id);

    /**
     * 通过用户ID获得会员角色
     *
     * @param userId 用户编号
     * @return 会员角色
     */
    List<MemberRoleDO> getByUserId(BigInteger userId);

    /**
     * 获得会员角色列表
     *
     * @param ids 编号
     * @return 会员角色列表
     */
    List<MemberRoleDO> getRoleList(Collection<BigInteger> ids);

    /**
     * 获得会员角色分页
     *
     * @param pageReqVO 分页查询
     * @return 会员角色分页
     */
    PageResult<MemberRoleDO> getRolePage(AppMemberRolePageReqVO pageReqVO);

    /**
     * 获得会员角色列表, 用于 Excel 导出
     *
     * @param exportReqVO 查询条件
     * @return 会员角色列表
     */
    List<MemberRoleDO> getRoleList(AppMemberRoleExportReqVO exportReqVO);

}
